home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / fulldb.exe / FULLDB.DOC < prev    next >
Text File  |  1991-10-15  |  7KB  |  181 lines
  1. FULLDB version 1.3 - Add .OBJ line number information to Turbo Pascal .TPU.
  2.                      Works with TP 5.5, TP 6.0, or TPW 1.0!
  3.  
  4.   Copyright (c) D.J. Murdoch, 1991
  5.  
  6. Syntax: FULLDB tpuname[.TPU] [/Oobjpath]
  7.  
  8.   reads the given .TPU file, and attempts to add line number information
  9.   from all externally linked .OBJ files.
  10.  
  11. Option:
  12.   /Oobjpath:  Search objpath for .OBJ files if they're not in the current
  13.               directory.
  14.  
  15.   This option may be kept in the TPC.CFG file, if that file is on the
  16.   PATH.  A command line option will override the TPC.CFG value.
  17.  
  18. Description:
  19.  
  20.   Turbo Pascal versions 4.0 and up allow you to link external .OBJ files
  21.   written in other languages.  Usually these are written in assembler,
  22.   since the requirements of the TP linker are very strict.
  23.   Unfortunately, all debugging information is lost, which makes it very
  24.   hard to get the assembler code right.
  25.  
  26.   FULLDB fixes this for TP 5.5 and 6.0, and TPW 1.0. If you can get your
  27.   external assembler/compiler to include standard line number
  28.   information in the .OBJ files, FULLDB will copy this into your .TPU
  29.   file.  This will enable you to single step through your external code
  30.   while in the TURBO IDE or in Turbo Debugger.
  31.  
  32. Example:
  33.  
  34.   The following demonstration files are included in this package.  I've
  35.   already done the first few steps in TP 6.0; skip right to compiling
  36.   DEMO.PAS if you're using that version.
  37.  
  38.   Assemble PARSE.ASM with included debug information:
  39.  
  40.     TASM /Zd PARSE
  41.  
  42.   Compile PARSE.PAS, which links in PARSE.OBJ:
  43.  
  44.     TPC /$D+ PARSE.PAS
  45.  
  46.   (Or use the TURBO.EXE IDE to compile it.  It's doesn't matter if you
  47.   include debug information for the Pascal part of the unit.)
  48.  
  49.   Add the PARSE.OBJ line number information to .TPU:
  50.  
  51.     FULLDB PARSE.TPU
  52.  
  53.   Now compile the DEMO program:
  54.  
  55.     TPC /V /$D+ DEMO
  56.      or
  57.     TURBO DEMO
  58.     <F9>
  59.  
  60.   and you'll be able to single step <F7> right into PARSE.ASM, in either
  61.   Turbo Debugger or the IDE.
  62.  
  63. Limitations:
  64.  
  65.   The record in the .TPU file giving the name of the .OBJ file doesn't
  66.   include date & time information.  If the file it finds isn't the same
  67.   one you linked into your .TPU, you're likely to get garbage line
  68.   numbers.  FULLDB will have no way to check on this.
  69.  
  70.   FULLDB can't read full debug information from the .OBJ file.  Only
  71.   line numbers are used, so local symbols won't be available to the
  72.   debugger.  Note that the TP 6.0 IDE has a Registers window available
  73.   using the <AltW>R command.
  74.  
  75.   The lack of local symbols is something I'm working on; if you register
  76.   this copy (see below), you may get the full debug version in the mail.
  77.   This effort would be greatly sped up if someone could point me to
  78.   documentation of the debug info formats in .OBJ files; I already know
  79.   how to add it to the .TPU file once I can read it.
  80.  
  81.  
  82. History:
  83.  
  84.   1.3 - Added search of TPC.CFG, and demonstration code
  85.  
  86.   1.2 - Added /O option
  87.  
  88.   1.1 - Fixed bug with large .ASM files
  89.  
  90.   1.0 - First version
  91.  
  92. License:
  93.  
  94.   FULLDB is not public domain.  It contains code whose copyright belongs
  95.   to D.J. Murdoch, as well as library code from Borland International
  96.   and TurboPower Software.
  97.  
  98.   You are free to use FULLDB without charge for one month.  If you keep
  99.   it beyond that time, you must register it by sending $20 (Canadian or
  100.   U.S. dollars) to me at the address below.  Mention your version
  101.   number; one update will be sent to you when available.  I'll also put
  102.   a collection of other freeware and shareware programming utilities on
  103.   the same disk.  (If you like, you can forgo the free update and
  104.   request the disk of other utilities immediately.)
  105.  
  106.   You may distribute FULLDB unmodified, together with this documentation
  107.   file, provided that you charge no more than distribution costs, and on
  108.   no account more than $10 per copy.
  109.  
  110. Source code:
  111.  
  112.   Source code to FULLDB is available to registered users at a cost of
  113.   $20 (Canadian or U.S. dollars).  Send your payment to me at the
  114.   address below.  You can register it and obtain source code at the same
  115.   time for $35 (Canadian or U.S.).
  116.  
  117. Warranty:
  118.  
  119.   There is no warranty of any kind with this program.  But it's
  120.   shareware - if it doesn't do what you want, throw it away. I can't
  121.   accept responsibility for any damage that bugs in it may cause.  If
  122.   you find any, please send reports to me (Duncan Murdoch) at one of the
  123.   following addresses:
  124.  
  125.   DJ Murdoch at Fidonet node 1:221/177.40
  126.   dmurdoch@watstat.waterloo.edu  on Internet
  127.   71631,122 on Compuserve
  128.  
  129.   79 John St. W
  130.   Waterloo, Ontario, Canada
  131.   N2L 1B7
  132.  
  133.          ----------------end-of-author's-documentation---------------
  134.  
  135.                          Software Library Information:
  136.  
  137.                     This disk copy provided as a service of
  138.  
  139.                            Public (software) Library
  140.  
  141.          We are not the authors of this program, nor are we associated
  142.          with the author in any way other than as a distributor of the
  143.          program in accordance with the author's terms of distribution.
  144.  
  145.          Please direct shareware payments and specific questions about
  146.          this program to the author of the program, whose name appears
  147.          elsewhere in  this documentation. If you have trouble getting
  148.          in touch with the author,  we will do whatever we can to help
  149.          you with your questions. All programs have been tested and do
  150.          run.  To report problems,  please use the form that is in the
  151.          file PROBLEM.DOC on many of our disks or in other written for-
  152.          mat with screen printouts, if possible.  PsL cannot debug pro-
  153.          programs over the telephone, though we can answer questions.
  154.  
  155.          Disks in the PsL are updated  monthly,  so if you did not get
  156.          this disk directly from the PsL, you should be aware that the
  157.          files in this set may no longer be the current versions. Also,
  158.          if you got this disk from another vendor and are having prob-
  159.          lems,  be aware that  some files may have become corrupted or
  160.          lost by that vendor. Get a current, working disk from PsL.
  161.  
  162.          For a copy of the latest monthly software library newsletter
  163.          and a list of the 3,000+ disks in the library, call or write
  164.  
  165.                            Public (software) Library
  166.                                P.O.Box 35705 - F
  167.                             Houston, TX 77235-5705
  168.  
  169.                                  Orders only:
  170.                                 1-800-2424-PSL
  171.                               MC/Visa/AmEx/Discover
  172.  
  173.                           Outside of U.S. or in Texas
  174.                           or for general information,
  175.                               Call 1-713-524-6394
  176.  
  177.                           PsL also has an outstanding
  178.                           catalog for the Macintosh.
  179.  
  180.  
  181.